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(57) ABSTRACT 

A query object generator tool which generates interface 
definitions and code that implement a query object also 
generates a graphic user interface (GUI) for controlling the 
generator tool and plug-in objects, including a database 
schema access query object and test objects for allowing the 
GUI to operate with vendor-specific databases. The GUI is 
"customized" by the various plug-in objects. For example, 
the database schema access query object is designed spe- 
cifically for a particular underlying database and retrieves 
"metadata" concerning the database schema. The retrieved 
metadata is then displayed as part of the graphic user 
interface to assist the user in constructing a query object. 
Test objects are also generated by the GUI in response to a 
user request. The test objects contain information that char- 
acterizes the query object for testing purposes. The infor- 
mation in the test objects is used with a test framework to 
install and initialize the query object. The test framework 
also uses the information in the test objects to customize part 
of the GUI in order to allow a user to view and interact with 
the installed query object. In particular, the customized GUI 
allows a developer to enter input parameters for a query 
directly from the interface and use the installed query object 
to perform a query with the input parameters. Results which 
are retiu-ned from the query are displayed on the interface. 
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SYSTEM AND METHOD FOR PROVIDING A clients, code replication is avoided. The Common Object 

QUERY OBJECT DEVELOPMENT Request Broker Architecture (CORB A) presents one object- 

ENVIRONMENT oriented approach to forming a three-tiered database 

environment, such as described in R. Orfali et al., "The 
FIELD OF THE INVENTION 5 Essential Qient/Server Survival Guide," pp. 375-458, John 

™. wj*u J Wiley & Sons, Inc. (2d ed. 1996), the disclosure of which is 

Tte present mvention relates, m general, to databases and incorporated herein by reference, 
methods for accessmg such databases with query objects. Several prior art methods of implementing the three-tiered 

and, m parUcular, to apparatus and methods for mteractively ^^^^^ ^J^^ ^^^^^^^^ ^^^^ ^^^l ^^^^ 
constructmg, testmg and usmg such query objects. j^ols, including fourth generation languages 

BACKGROUND OF THE INVENTION (4GLs) and apphcation programming interfaces (APIs), 

have been designed for the two-tiered model and are ill- 
Databases represent an important data processing area in suited for use in the three-tiered model. Consequently, 
many applications. They are often used to store large several prior art designs including "database" objects and 
amounts of information and then efiBciently retrieve selected "active data" objects have their own strengths and draw- 
portions of the information. Many present day systems use backs. One promising prior art approach to constructing a 
a client/server database approach in which apphcation pro- middle tier containing business logic uses "query objects." 
grams running in clients access a central database manage- Each query object is a server object that: 
ment system (DBMS) located in a database server. In order (1) translates client method invocations into equivalent 
to efficiently access the information in the database, the queries in a query language which is understood by a 
cUents form queries which request information with selected database; 

characteristics. The queries are transmitted to the DBMS Yi ^^^^ '^''^"^^ database; and 

server which retrieves the desired information which meets P^returns the results as strongly-typed data values, 
the characteristics specified in the query. The results ^^^^ ^^J^^^ effectively encapsulates the DBMS 

(commonly called a "result set") are returned to the client. ^P^'^'^'^ '^''^^ language so that the application programs do 
^ ,1 u ^ * u . J • 1 25 not have to know or use the DBMS query language. Query 
Presently, such database environments are predominantly u* * i 1 * j . l ^ . 

, J , , . . ^ ^ , ^.^ objects also encapsulate the database organization or 

based on a "two-tiered' model consisting of a top tier « . « , u- * i- * • t . ^ c 

, . . , . u . schema , so that query object clients are isolated from 

contaimng one or more apphcations which generate quenes u / uu u i_- . ,r 

that access the DBMS ser;er in a bottom tier^ THe two-tiered ^u^^^ZtT^^^^^^ T.I ' ^ T ''J^ 

model suffers from several drawbacks. First, the queries ^o be changed ff the underlymg database must be 

must be formulated in a specific query language, which is f^Ttj^ ^ ^ nn^tlT^"^'^ \ 

o^^.„t^^ u.r tu^ T\u\Mc wk i * A A 1 mdependent API, for example, CORBA defines an Interface 

accepted by the DBMS server. While standard query Ian- £• r /ttxt\ • , 

■ , u o* . J T ri^Tx Definition Language (IDL) mterface. They do not requu-e 

guages exist, such as the Structured Query Language (SQL), ,1,^ \.u* ♦ • i^H""'^ 

r^n\Ac 1 J J that the data be mapped mto objects as is the case with active 

specific DBMS query languages are often non-standard as a a.*, ^w^^*. *u / • •« / f a 

.7 ^ J... ,*o^T data objects so that significant performance advantaees can 

result ofproprietary extensions made to the basic SQL query u - a a - j j uia^va ^au 

1 ^ 1*- . ^ ^ ^ 35 be obtained and CO ncunence issues avoided, 

language. As a result, application programs wntten to gen- c 1, u* * j . r . • . ^ 

erafe queries in a parti^lar query language are often not Each query object provades, as part of its mterface one or 

portable between different DBMS serv?^ f'T^'f ^'^^ °° ^''^ method are 

. translated by the query object into one or more standard 

In addition, m order to generate the queries m the first queries such as SELECT, UPDATE, INSERT and DELETE 
p ace, each apphcation developer, and, in some cases, the 40 or into the initiation of one or more stored procedures in the 

ultimate user, must understand the mechanics of the database. In order to use the query object, a client first 

database, mcluding the relationship of the files and tables establishes a connection to the query object via some 

therein and any relationships in the data required by the mechanism, such as a CORBA naming service. One of the 

databa^ organization. These relationships are commonly j^ethods is invoked and the query object then executes the 
referred to as business logic since the relationships are 45 q^ery. The method is then invoked to execute the query. 
typicaUy based on shared business processes, practices and However, in order to operate properly, the query object 

policies. Therefore, many parties must learn the business constructed to generate the correct DBMS queries 

logic in order to generate meaningfiil queries. ^ ^^p^^, ^j^^^j ^^q^^^^^ Otherwise, the query object 

Further, commonly-performed routmes are typically rep- may operate as designed, but produce results which are not 
heated in each apphcation program even if the application 50 intended. Constructing a query object to generate the correct 

programs operate within the same business environment queries requires a knowledge of SQL, an understanding of 

because each apphcation functions autonomously from the underlying database schema, the possible handling of 

other apphcations. This replication results in poor code intermediate results generated by the query and interpreta- 

re-use and maintenance problems if the rephcated routines tion of the results. In addition, a query object developer must 
must be changed. 55 consider other issues such as connection to the database 

Consequently, there is a trend towards using a three-tiered using CORBA or similar arrangement, concurrency prob- 

model for database envu*onments. Generally, the top tier in lems and translation required between the interface used by 

such a model consists of chents containing the application the query object and the API used by the database, 

programs and the user interfaces, the middle tier consists of Consequently, tools have been developed to automate the 
code that embodies the business logic and the bottom tier 60 generation of query objects. Some tools can generate a query 

consists of the DBMS servers which contain the data. In this object from a query described in conventional SQL language 

model, the apphcations are implemented as "thin" cfients, all which is entered by a user. 

of which interface with the business logic by means of a However, even with such tools, it may be necessary to 

common interface which does not involve knowledge of the understand the schema of the underlying database in order to 
business logic. The commonly-performed routiner are all 65 correctly construct the initial SQL query and map the SQL 

consolidated into the middle tier as part of the business query into the query language used by the underlying 

logic. Since the business logic is shareable between the database. 
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Further, a need for testing the generated query object with of the GUI in order to allow a user to view and interact with 
actual data exists. For example, the query may not have been the installed query object. In particular, the customized GUI 
correctly written by the user or may produce unexpected allows a developer to enter input parameters for a query 
results. In order to generate a test facility for the query directly from the interface and use the installed query object 
object, it may be necessary to understand the internal 5 to perform a query with the input parameters. Results which 
construction of the query object and its operation. If the are returned from the query are displayed on the interface, 
query object was generated with an automated tool, infor- 
mation concerning the construction of the object and its BRIEF DESCRIPTION OF THE DRAWINGS 
operation may not be i^adily available and it may be The above and further advantages of the invention may be 
nece^ary to examine the inner workings of the query object 10 better understood by referring to the following description in 
in order to properly construct a test platform^In addition, if conjunction with the accompanying drawings in which: 
the query object is used with a distributed object system, it 

may be necessary to first install, then locate the query object ^ ^ ^^''''^ schematic diagram of a chent server 

in order to test it system on which the present invention can be operated. 

While these latter operations are well-known, they can be 15 2 is a block schematic diagram illustrating the 

time-consuming details which distract the user from other, interaction between client object, business objects and query 

more important work. It would be highly desirable to objects in a three-tiered system. 

coordinate the creation, initialization and testing functions in FIG, 3 illustrates the generation of a query object and 

an integrated environment, preferably an integrated visual associated test objects, query test objects and a database 

environment. Such an environment would allow a user to 20 schema access object from information in the underlying 

easily view the specifics of the underlying database, quickly database and query object library files, 

construct a query object, install the object and test it with FIG. 4 illustrates how code generated by a query object 

actual input data and with the actual database on which it is generator tool is used with a CORBA distributed object 

to operate and then easily modify the object if it does not system. 

perform as expected and retest the object. 25 pjc. 5 iuustrates the internal architecture of an iUustrative 

rinally, it would also be desirable to be able to easily « u- * * * i 

^•^ . J , . , , ^ query object generator tool, 
connect such a development environment with databases 

sold by different vendors so that a consistent interface is ^^^^ diagram of the classes used to construct 

presented to the user no matter which database is actually ^^''^^^ displays. 

used to execute the query. 30 FIGS. 7Aand 7B, when placed together, form a flowchart 

Therefore, there is a need to provide a visual integrated illustrating a routine which generates a main screen display 

development environment for generating, installing, initial- handles button presses, 

izing and testing of query objects which can operate with FIG. 8 is the GUI main screen display which allows a user 

different databases while presenting a consistent interface to to manipulate new and existing query objects. 

^ 35 PIG. 9 is a screen display of a login screen which allows 

SUMMARY OF THE INVENTION '° ' ''^""'^ '''' °' " ^^"^^ 

The foregoing problems are solved in one illustrative FIG. 10 is a screen display of a query add/edit screen 

embodiment of the invention in which a query object which allows a user to create or edit the contents of a query 

generator tool which generates interface definitions and code object illustrating the customization of the GUI display 

that implement a query object also generates a graphic user using database schema information retrieved by the database 

interface (GUI) for controlling the entire system and plug-in schema access object. 

objects, including a database schema access query object FIG. 11 is a generate screen display generated of the 

and test objects for allowing the GUI to operate with inventive generator tool GUI. 

vendor-specific databases. FIG. 12 is a screen display generated by the TESTQOF- 

The GUI has a fixed appearance which is "customized" by rame object, 
the various plug-in objects. For example, the database FIGS. 13A and 13B, when placed together, form a flow- 
schema access query object is designed specifically for a chart which illustrates it the steps in a routine for performing 
particular underlying database and retrieves "metadata" con- a query object test. 

cerning the database schema. The retrieved metadata is then piG. 14 is a screen display illustrating the resuUs of a 

displayed as part of the graphic user interface to assist the q^ery performed with a query object showing input param- 

usermconstructmg a query object. eter names and output column titles. 

In accordance with one embodiment of the invention, the 

user writes a query which is to be implemented as part of a 55 DESCRIPTION OF THE PREFERRED 

query object in a generic query language such as SQL. The EMBODIMENT 

database schema access object can be used to verify the piG. 1 is a block diagram of a system 100 on which an 

syntax of the genenc SQL query by converting the query to illustrative query object generator tool constructed accord- 

the vendor-specific language used by the database and ing to the present invention can run. As shown, the system 

submitting the query to the database engine. ^o 100 is a distributed computing environment comprising a 

In accordance with another embodiment of the invention plurality of individual computer nodes 102, 104, 106 and 

test objects are also generated by the GUI in response to a 108. The nodes are functionally organized into clients 102, 

user request. The test objects contain information that char- 104 and 106 and at least one server 108 interconnected over 

acterizes the query object for testing purposes. The infor- a network 105. However, the clients 102, 104 and 106 and 

mation in the test objects is used with a test framework to 65 server 108 can also be implemented on a single node. Each 

install and initiaUze the query object. ITie test framework node, whether a cUent 102, 104, 106 or server 108, is a 

also uses the infonnation in the test objects to customize part conventionally programmed digital computer, respectively 



08/06/2002, EAST Version: 1.03.0002 



us 6,430, 

5 

including a central processing unit (QPU) 118, 122, and a 
main memory 112, 124 interconnected with the CPU 118, 
122, In addition, each client 102-106 and server 108 can 
include user interfacing devices, such as a monitor 114, 
keyboard 116 and mouse 117 and a storage device 112 5 
(shown in FIG. 1, by way of example, for just one client 
102). The server 108 includes a database 110, such as a 
relational database, file system or other organized data 
storage system. The individual components implementing 
each node 102-108 are interconnected over a central system 
bus (not shown) used for exchanging address, data and 
control signals, although other forms of component inter- 
connections are possible. Finally, the system 100 can include 
devices for accepting computer-readable storage mediums 
(not shown) and can be interconnected with the network 105 ^5 
for exchanging data and control signals transmitted as a 
computer data signal in a carrier wave. 

In the described embodiment, each node 102-108 is a 
network connectable computer, such as a Sun SparcSta- 
tion'^"5 workstation running the Solaris™ operating system, 20 
a version of the UNIX® operating system, or an IBM- 
compatible computer, running the Windows NT™ operating 
system. However, use of the systems and processes 
described and suggested herein are not limited to a particular 
computer configuration. SparcStation™ and Solaris™ are 25 
trademarks of Sun Microsystems, Inc., Mountain View, 
Calif. UNIX® is a registered trademark of The Open Group, 
Cambridge, Mass. Windows NT™ is a trademark of 
Microsoft Corporation, Redmond, Wash. 

Distributed computing environments can be logically 30 
viewed as of a set of cooperating software components, 
referred to as "objects," being executed on one or more 
computers interconnected by a network. The individual 
applications mnning on each computer can share a set of 
standard or application-specific objects and executing an 35 
application can cause it to interact with and use other 
software objects available locally and throughout the net- 
work. Each such object can, in turn, itself use other software 
objects. Thus, an application in a distributed computing 
environment can consist of the combination of application- 40 
specific objects and the combined local and remote objects 
it uses. When one object calls an operation on another 
object, the calling object is referred to as the "client" while 
the called object is referred to as the "server." FIG. 2 is a 
block schematic diagram of a database client/server envi- 45 
ronment 200 using query objects 208 and 214 as might be 
implemented in the system 100 of FIG. 1. The environment 
200 is functionally structured into three tiers. In the top tier 
203, a client 102 (shown in FIG. 1) executes an application 
202. The application 202 interacts, as indicated schemati- 50 
cally by arrow 204, with business logic in the middle tier 
205, The business logic is implemented as one or more 
business objects 206 (only one business object 206 is 
shown) and, in turn, interfaces with query objects 208 and 
214. Both the business object 206 and the query objects 208 55 
and 214 can be executed on either a client 102 or a server 
108 (shown in FIG. 1). Other combinations and .configura- 
tions of objects, including business object 206 or query 
object 208 and 214 are feasible. 

In the bottom tier 207, a server 108 and an associated 60 
database 110 (shown in FIG. 1) include database manage- 
ment systems (DBMS systems) 218 and 222 (which may be 
executed on the server 108) along with associated databases 
224 and 226, respectively. Query objects 208, 214 allow the 
business logic implemented in the business object 206 to 65 
access the DBMS systems 218, 222 without knowledge of 
the DBMS schema or query language. 
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More particularly, query objects 208, 214 are server 
objects that translate client requests into appropriate DBMS 
queries, issue those queries to the DBMS systems and return 
the results to the client. Functionally, each query object 208, 
214 creates a logical "wrapper** that encapsulates a specific, 
apphcation-dependent set of queries and provides the results 
to its clients as strongly typed values. Each query object 208, 
214 is associated with a single DBMS system 218, 222, 
respectively, and has the capability of interacting with 
specific DBMS query APIs (represented by arrows 216 and 
220) and parameters for the queries. However, the query 
object provides a DBMS-independent API (represented by 
arrows 210 and 212, respectively) to the business object 206 
for accessing the databases 224, 226. Each query object also 
provides a mechanism for managing connections to the 
DBMS systems 218, 222 associated with the databases 224, 
226, including methods for locating the databases 224, 226 
in the distributed environment, methods for logging on to the 
DBMS systems 218,222 and facilities for managing the 
connection resources. A query object may also provide 
multi-threading support, if necessary. 

Each query object may include several distinct queries. 
The query object code for each query is created by a query 
object generator tool in response to a query written by the 
query object developer in a standard language, such as SQL. 
In order to assist the, developer in writing the SQL language 
queries, the query object generator tool utilizes the inventive 
database schema access object to retrieve and to display the 
schema of the underlying database to the developer. Since 
the database schema access object is closely tied to the 
underlying database, the database schema access object also 
serves as a repository of code to perform other database- 
related activities. These activities include, submitting a 
proposed query to the underlying database query engine in 
order to validate the query and performing data type trans- 
lations between the SQL data types used in the developer- 
formulated queries and the vender-specific data types of the 
underlying database. 

Quj B^mQ>JejetSi6 , a n J yg^an^^g^^^ 
ated by an autoniaTE^dige^^^]ortool' In accordance with the 
principles gjKE^^^tion, the generator tool is controlled 
by a G Ujiandi pi^^es a completely integrated environment 
in \ffigM5lG @tjS.«^s ajjg;| giQ^i#iandi^ FIG. 
3 illustrates the operation of a generator tool which gener- 
ates the components of a query object and, optionally, the 
components of a database schema access object which 
allows the database schema to be displayed and test objects 
which test the query. In particular, the query object generator 
tool 300 utilizes information obtained from database 304 
and query object hbraries 306 to construct a query object 
308, a database schema access object 316 and test objects 
318. The query object generator tool 300 then uses the 
database schema access object 316 for obtaining the data- 
base schema from database 300 as indicated schematically 
by arrow 305. The database schema may be presented to a 
user by means of the GUI 302 to aid the user in formulating 
a query which is consistent with the database schema. When 
the query information has been obtained from the user, the 
query object generator tool 300 utilizes object-oriented class 
code found in the query object library 306 to instantiate code 
generator objects (not shown) as indicated schematically by 
arrow 307. The code generator objects then generate the 
source code for the query object 308 as indicated by arrow 
310. The code generators may also generate build scripts 
(not shown) which allow the query object 308 to be built 
from the generated source code. 

Tho code generators also use the information obtained 
from database 304 and libraries 306 to generate test objects 
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318 as indicated by arrow 312. The test objects correspond comprises the interface between the ORB 412, the skeleton 

to the query object 308 and, each of the queries in the query code 408 and the server 420. Object adapters, such as 

object 308. llie test objects 318 are used with a test adapter 410, support functions, such as registration of object 

framework to generate a test GUI which can display and run implementations and activation of servers, 
the queries in a query object as described below. 5 The query object generator tool preferably generates a 

In the preferred embodiment, the client/server environ- query object, a database schema access object and test 

meat 200 is implemented in compliance with the Common objects for use with a conventional CORBA system such as 

Object Request Broker Architecture (CORBA), such as that illustrated in FIG. 4. When operating with such a 

described in "The Common Object Request Broker: Archi- CORBA system, the query object generator tool 416 gen- 

tecture and Specification," Rev. 2.0, Object Management erates CORBA IDL interface code 418. This IDL code is 

Group, Inc. (July 1995), the disclosure of which is incor- applied to a conventional IDL compiler 422 which, in turn, 

porated herein by reference. The application 202, business generates the client stub code 406 and the server skeleton 

object 206 and query objects 208, 214 each export an API 408. 

defined in Interface Definition Language (IDL) and. inter- The internal architecture of the query object generator 

face with each other via an associated Object Request is ^^^j ^^^^ generate the aforementioned 

Broker (ORB) illustrated in FIG. 4. Each query object 208, objects and which interacts with the objects is illustrated in 

214 returns a set of IDL structures whose type is derived block schematic diagram form in FIG. 5. The query object 

from the database schema at the time the query object 208, generator tool 500 comprises a query object internal state 

214 is unplemented and this interface is used by chents of object 502, code generator object 504 and a builder object 

the query object. In a similar manner the test object and each 20 ^^^^ ^^^^^^ internal state object 502 allows the 

of the query test objects also export an IDL interface which user to save a logical definition of a query object in an 

msures that they wiU be compatible with the test framework, intermediate file, such as file 512. In particular, object 502 

FIG. 4 illustrates, in a very schematic form, the basic can store and retrieve file information in file 512 as indicated 
CORBA architecture which defines a peer-to-peer distrib- schematically by arrow 514. The information saved in file 
uted computing facility where all applications are objects (in 512 is not the entire query object but is sufficient amount of 
the sense of object orientation). In such a system, a client information to be able to reconstruct the query object. This 
400 communicates with the server 402 by means of an object allows the user to open an existing query object for modi- 
request broker or ORB 412 an object, such as a query object fication without having to restart from the beginning. In 
or a test object can be located on the server 402. The ORB addition, the internal state object 502 does not contain 
412 operates with a transport 414 that conveys information "^^ database specific information which allows the same query 
between the client 400 and server 402. The client 400 object to be implemented with different vendor-specific 
communicates with the ORB 412 by means of the afore- databases without rewriting the query object, 
mentioned IDL interface and a reference to the query object The query object internal state object 502 is actuaUy a 
or the test object. The object reference, in turn, contains an collection of objects which model input parameters, result 
identification of the object implementation 420 in the server structures and various implementation options. In accor- 
402 so that the server 402 can pass a request to the correct dance with the principles of the invention, the query object 
object implementation. The object implementation 420 then generator tool 500 is controlled by a graphic user interface 
performs the desired actions. 534 which enables a user, at terminal 536, to operate 

The entire CORBA architecture is actually implemented interactively with the generator tool 500. 
in a conventional programming language, such as C, C++, Generator tool 500 also receives information from the 
SmaUtalk or JAVA. Implementations in a variety of Ian- database 522 in order to aUow the user to formulate a query 
guages are available from a number of vendors who typi- and test the query. Extracting information from the database 
cally provide a compiler, called an IDL compiler 422, 522 can be performed in several manners. Preferably, gen- 
bundled with their ORB products. The compiler 422 gen- erator tool 500 uses a database schema access object 518 to 
erates header files which define the OMG IDL interfaces and retrieve the schema of the underlying database 522 as 
can be incorporated into application programs. The compil- indicated schematically by arrow 520. The schema informa- 
ers also generate the client stub code 406 and the server tion is remmed to generator tool 500 as indicated by arrow 
skeleton code 408 for each interface. 5I6 and may be presented graphically to the user by means 

The chent 400, which may be the generator tool, can 50 of the GUI 534 on terminal 536. The schema information 

directly link to the OMG IDL stub code 406. As far as the assists the user in formulating a query, 

client is concerned, an invocation of the stub code 406 The generator 500 also receives input information from 

appears to be a local function call. Once invoked, the stub the configuration file 508 and include files 510. The tool 500 

code 406 provides an interface to the ORB 412 that encodes reads the configuration files 508 when it starts up. These files 
the operation's parameters into communication formats suit- 55 tell the tool 500 about the environment in which it is running 

able for transmission on the transport 414 to the server 402. and they include such information as the JDBC drivers that 

The stub code then transmits a request for service to the are available and the location of various software programs, 

server 402. The configuration files also contain the name of the include 

At the server side, the OMG IDL skeleton code 408 is the directory 510 which contains various "boilerplate" files, 
corresponding it implementation of the OMG IDL interface. 60 When the tool 500 starts up, it first tries to read the 

When the ORB 412 receives a request, the skeleton code 408 configuration file in a directory that is "hard coded" into the 

decodes the request parameters and generates a call to the tool. If the configuration file is not found, the tool then looks 

object implementation 425 in the server 402. When the for a configuration file in the user's home directory. If the file 

server completes processing of the request, the skeleton code is still not found, the tool looks in the current directory. 
408 and stub code 406 return the results to the client 400. If 65 Generator tool 500 may further receive query strings and 

an error has occurred, exception information generated by parameter information from the user, via terminal 536. After 

the server or by the ORB is returned. An object adapter 410 the input information has been received, the query object 
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generator tool 500 utilizes an appropriately selected code FIGS. 7A and 7B illustrate a basic routine which gener- 
generator 504 to generate the source code which implements ates the main GUI screen of the present invention and 
the query object. In particular, the code generator 504 processes menu option selections. The routine starts in step 
generates the query object server implementation 524 and 700 and proceeds to step 702 where a QryObj object is 
the query object IDL code 525 and, as mentioned above, 5 instantiated from QryObj class 602. This instantiation might 
may optionaUy generate a database schema access server be performed by selecting a menu option on another pro- 
implementation and IDL code. The code generator object gram or via a command line interface. In any case, a show( ) 
which is actually used to generate specific query object method is called in the QryObj object to display the main 
source code must generate code which is compatible with screen. Anew internal state object is also instantiated in step 
the underlying database and is also written in the imple- 704 in order to represent the query object which will be 
mentation language which is used to implement the CORBA created or edited. The internal stale object is used to describe 
server Accordingly, the code generator classes are arranged the query object in a database independent manner so that 
in a class hierarchy with subclasses that depend on the the query object can be saved and edited at a later time. As 
implementation language and the underlying DBMS Ian- discussed below, this internal state object can also be used 
guage. to delete and save the query object. 

In addition, the tool 500 may also generate build and The GUI main screen display is shown in FIG. 8. The 

package scripts 526 which can be used to build the objects query object generator tool is much like any other editing 

from the source code 524 and the IDL code 525. The source program which allows a user to define and examine one or 

code and the build scripts are provided to a builder object more query objects, change their definitions and manipulate 

506 which generates the final query object package 532 that them in various ways. The query objects are selected by 

can be installed on a CORBA server. As previously using a graphic user interface which has a list 804 of the 

described, the query object IDL interface code 525 is pro- queries in the query object which shows the state of the 

vided to a conventional IDL compiler to generate the client current query object being defined and a menu of operations 

stub code and server skeleton code. 806 which allow a query object to be manipulated. For 

Finally, the tool 500 can generate and build test objects ^5 example, the "File" menu 808 options might include such 

which can test the queries in a query object. options as "New" which would allow a new query object to 

In accordance with the principles of the present invention, be created. Another menu options might be "Open" which 

the tool 500 is driven by a GUI 534 which controls all would allow an existing query object to be restored from an 

aspectsof query object generation and testing and automates intermediate file. A "Save" option would allow the query 
many of the routine chores. The classes which form the GUI 33 object contents to be stored in the intermediate file, 

are illustrated in FIG. 6. The QryObj Scr class 600 and its Each query object contains one or more queries which are 

subclass QryObj 602 create and display a "main" screen also displayed on the graphic display. The queries can be 

which allows a user to create and edit query objects. The manipulated by other menu options 810. These options 

QryObjScr class 600 contains the basic objects, menus and might include such operations as "Add Query", "Delete 
controls which fonn the display screen. The QryObj class 35 Query" and "Mo dify Query" . Finally, further menu options 

602 contains methods which start the display and process 812 are provided wLicn allow code for queries which have 

method selections from the main menu. These selections been created to be generated and built. The "Options" menu 

include the menu options "New", "Generate", "Add", might include such options as "Generate." 

"Edit", "Delete", "Open", "Save", "Saveas", "Properties" Returning to FIG. 7, the routine then enters a menu 

and "Exit", selection routine consisting of decision steps 706-746 which 

Selection of the menu option "New" instantiates a login perform various actions depending on which menu option 

object fi-om the login class 610 which is a subclass of the was selected. For example, if the "New" menu option is 

LoginScr class 608, As with the QryObjScr class 600, the selected as illustrated in step 706, then a Login object is 

LoginScr class 608 contains the basic objects, menus and instantiated from the login class 608, The Login object 
controls which form the display screen whereas the Login 45 displays a login screen as indicated in step 708. The login 

class 610 contains methods which start the display and screen is discussed below. After the login screen is 

process method selections from command buttons on the displayed, the routine then proceeds, via off page connectors 

login display screen, 722 and 728, to finish in step 748. 

Similarly, selection of the menu option "Generate" instan- If the "New" menu option is not selected in step 706, the 
tiates a Generate object from class 606 which descends from 50 routine proceeds to step 710 where a determination is made 

the GenerateScr class 604. The Generate object contains a whether the "Open" menu option has been selected. If the 

method which creates a thread that, in turn, generates and "Open" menu option is selected, the routine proceeds to step 

builds a query object, generates and builds a test GUI for the 712 in which a connection is opened to the selected query 

query object and optionally runs the test GUI to test the object. The previously instantiated internal state object 
object. 55 receives the stored query object parameters. 

Selection of the "Add" menu option instantiates a Qry Add Similarly, if, in step 714, the "Save" menu option is 

object from the QryAdd class 616 which, in turn, descends selected, then the routine proceeds to step 716 where a 

from the Qry class 614 that is a subclass of the. QryScr class method in the internal state object is used to save the 

612. The QryScr Class 612 contains the basic objects, menus selected query object. In all three cases, the routine then 
and controls which form the display screen whereas the Qry 60 finishes in step 748. If the "Save" menu option is not 

class 614 contains methods which start the display and selected in step 714, the routine proceeds, via off-page 

process method selections from command buttons on the connectors 720 and 724 to step 730 where a determination, 

login display screen. The QryAdd class 616 customizes the is made whether the "Delete" menu option has been 

display for the add function. Similariy, selection of the selected. If so, the routine proceeds to step 732 where a 
"Edit" menu option instantiates an object from the Qry Edit 65 method in the internal state object is used to delete the 

class 618 which, in turn, descends from the Qry and QryScr selected query object. ^Fhe routine then proceeds to step 748 

classes 614 and 612. to finish. 
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Individual queries in the query object can also be manipu- 1010 which calls a method in the QryAdd object that first 

lated by using the menu options in the "Query" menu 810 checks the query parameters to determine if they are vaHd 

(FIG. 8.) For example, in step 734, the routine determines and then submits the query to the underlying database query 
whether the "Add Query" menu option has been selected. If engine to determine whether the query syntax is proper. In 
so, then the routine proceeds to step 736 in which a QryAdd 5 a preferred embodiment, a method in the aforementioned 

object is mstanuated from the QryAdd class 610 and an add database schema object is used to submit the query to the 

query screen (disclosed below) The routine then proceeds, database and to rollback any changes in the database to 

to linish in step 748 prevent the query syntax test from modifying data. If the 

If, in step 734, the Add Query menu option is not query is correct then the QryAdd object adds the query to the 

selected, the routine proceeds to determme, in step 738, object 

whether the "Edit Query" menu option has been selected. If rjJ t. ur^ «, . ^^-.^ 

so, a QryEdit object instantiated from the QryEdit class 614 ^^^^^ ^'^"oo 1^^^ to cancel the 

and a corresponding display screen is displayed. The add query object operation or the "Clear" button 1014 which 

QryEdit object manipulates the query selected in list 804 ^^^^^^ contents of the text fields 1002 and 1004. In either 

(FIG. 8). The routine then finishes in step 748. case the GUI redisplays the main screen illustrated in FIG. 

Alternatively, if the "Generate" menu option is selected as ^• 

indicated in step 742, the routine proceeds to step 744 where The generate display screen is illustrated in FIG. 11. This 

a Generate object is instantiated and a generate display screen is generated by the generate object instantiated from 

screen is displayed. The routine then proceeds to finish in the generate class 606 (FIG. 6.) Code for a query object can 

step 748. be generated by manipulating screen 1100 which displays 

If in step 738 the "Generate" menu option is not selected, two options for the query object which are controlled by 

the routine proceeds to step 746 where a determination is checkboxes 1102 and 1104, These options allow the code for 

made whether the "exit" menu option has been selected. If the query object to be generated and built, respectively, 

the "Exit" menu option has been selected, the routine ends After options have been selected, the corresponding 

in step in 748. Alternatively, if the "Exit" menu option was operations are initiated when the user presses the "Generate" 

not selected, the routine returns, via off page connectors 724 command button 1112. The "Generate" command button 

and 718, to step 706 where the menu options are again 1112 creates a thread which, depending on the state of the 

reviewed. Operation continues in this manner until one checkboxes 1102-1110, generates the code for the query test 

option has been selected. object, builds the query test object from the generated code. 

The login screen which is displayed by the graphic user generates code implementing a test GUI, builds the test GUI 

interface when the user selects the "New** menu option is and runs the test GUI. 

illustrated in FIG. 9. This screen is also displayed if the user In particular, the thread instantiates a code generator 

tries to open an existing query object, but has not logged into object which generates the code required to implement the 

the database which underlies the query object. This screen query object as defined by the internal state object. The code 

900 includes four text fields 902, 904, 906 and 908 which generator classes are arranged in a hierarchy so that a 

allow the user to enter an identifier, such as URL, which generator object can be instantiated which generator object 

specifies the location of a database in the network is specific to the database to be accessed and the language to 

environment, the user's name and password and the name of which the implementation is targeted, 

the query object to be created. The code generator object then generates both interface 

After entering the information, the user presses a "Login" code to allow a client to access the object and code which 

command button 910 which causes the query object gen- implements the object for a specific DBMS and transactional 

erator tool to log in to the database located at the URL model. A preferred method for generating the query object 

entered in text box 902 with the user's name and password code is to use a set of code generator sections which print 

entere[0084] in boxes 904 and 906, respectively, A con- predetermined text strings. Specific generator sections can 
nection to the query object whose name was entered into text 45 then be selected based on the SQL input string, 

box 908 is then attempted if the user is opening the object. Also, in accordance with a preferred embodiment, the 

Alternatively, the user can press a "Cancel" command button code generator object generates build scripts which can be 

912 to cancel the operation or a "Reset" command button run to compile and build the query object depending on the 

914 to clear all of the text fields 902, 904, 906 and 908 to checkboxes 1102, 1104 which are selected in the generate 

50 screen display. Code generation options can be canceled 

Selection of the "Add Query" menu option instantiates a when the user presses the "Cancel" command button 1114, 

QryAdd object, which, in turn, displays the screen shown in Finally, the "Reset" command button 1116 causes the check- 

FIG. 10. llie Add Query screen 1000 contains a text field boxes 1102-1110 to be reset to their default configuration. 

1002 which allows entry of a new query name and a text As previously mentioned, a test GUI can also be gener- 
field 1004 which aUows entry of the SQL query text. 55 ated by the query object generator tool. Three options, 

The database schema area 1008 displays details of the represented by checkboxes 1106, 1108 and 1110, allow code 
database schema which have been previously retrieved,by for this test program to be generated and built (code gen- 
means of a database schema access query object or in eration and building are controlled by checkboxes 1106 and 
another manner as previously described. The display con- 1108.) The program can optionally be run as controlled by 
sists of a scrolling list 1016 of tables, views and stored 60 checkbox 1110. The test object source code generated by the 
procedures. When one of these database "objects" is code generator operates with a test framework to generate a 
selected, its schema description, including column names customized GUI which allows a user to view and manipulate 
1018 and data types 1020 can be displayed. The schema a query object. In particular, the test framework consists of 
display assists a user in correctly constructing the query three classes: the TestQO class, the TestQOFrame class and 
string in text box 1004. 65 the RunQuery class. 

After the SQL query string has been constructed in text The TestQO class is a test driver class designed to work 

box 1004, the user can press the "Apply" command button as an application or a JAVA applet which is launched by the 
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aforementioned thread and instantiates an object from the eter. Two buttons, 1404 and 1406, are also created on the 

TestQOFrame class in order to create a GUI window. The screen which allow the query to be performed or dismissed, 

TestQOFrame object then displays the resulting screen dis- respectively. 

play. This screen display is illustrated in FIG. 12 and allows Also included on the screen, are a number of columns, 
a user to select one of the queries in the associated query 5 1408 which display the output data. The output titles 1418 

object and to run the query. In particular, the TestQOFrame are the titles received from the query test object, 

class creates a push button 1202 for each query on the screen A software implementation of the above -described 

display which push button is labeled with the name of the embodiment may comprise a series of computer instructions 

query and permits the user to-a method in the query object either fixed on a tangible medium, such as a computer 
which, in turn, causes the query object to perform the query. lO readable media, e.g. a diskette, a CD-ROM, a ROM 

A stop button 1204 is also provided to cancel testing. memory, or a fixed disk, or transmissible to a computer 

n r\ i * ..^t^^ti^^^A * j systcm, via a modem or other interface device over a 

The RunQuery class is instantiated to set up and run a -rn - i_ -.u * li i* 

J * 1 u 4* I'lA'i * J . . medium. The medium can be either a tangible medium, 

query under control of the buttons 1202 created on the test • i j- ^ * i , . 

r^TTT J- 1 iinA u T ,r\rMj u* * Tn. r> including, but not limited to, Optical or analog communica- 

GUI display 1200 by the TestQOFrame object. The Run- i- , . i . ^ •♦u - i * u • 

V ^.-^ uu ...L-if tions lines, or may be implemented with wireless techniques. 

Query class contams a constructor which constmcts the 15 ' . i* j * • • c a \x. 

^ A x^' , A r / \ c P mcluding but not limited to microwave, mfrared or other 

RunQuery object and an act,on( ) function for processing techniques. It may also be the Imernet. Tlie 

button presses. - r * ■ * * • u n r 

^ . ^ o • . • . . series or computer instructions embodies all or part of the 
^^'^V?^^ a query object test is illus- fixnctionality previously described herein with respect to the 
trated m FIGS. 13A and 13B which, when placed together, invention. Those skilled in the art wiU appreciate that such 
form a flowchart. Such a routme might be mitiated, for 20 instructions can be written in a number of pro- 
example, by the aforementioned thread that is used to g^amming languages for use with many computer architec- 
generate and build the query object. When the TestQO applet ^ures or operating systems. Further, such instructions may be 
IS run It instantiates a TestQOFrame object as mdicated in stored using any memory technology, present or future. 
Step 1304. mTestQOFranae object IS used to generate the including, but not limited to, semiconductor, magnetic, 
display wmdow, shown m FIG. 12. 25 ^^^.^^^ ^^^^^ ^^^^^ ^^^.^^^ transmitted using any 

When the TestQOFrame class is instantiated, its construe- communications technology, present or future, including but 
tor calls a method in the TestQO applet. This method not limited to optical, infrared, microwave, or other trans- 
instantiates a test object generated for the query object under mission technologies. It is contemplated that such a corn- 
test as indicated in step 1306. The constructor of this object puter program product may be distributed as a removable 
also creates and initializes the ORB which is necessary to media with accompanying printed or electronic 
connect to the query object in a CORB A environment. If a documentation, e.g., shrink wrapped software, pre-loaded 
CORBA environment is not used then the test object can be with a computer system, e.g., on system ROM or fixed disk, 
located in another conventional manner, such as with a or distributed from a server or electronic bulletin board over 
naming service that returns a reference to the object. Using a network, e.g., the Internet or World Wide Web. 
the ORB, the test object constructor obtains the route Although an exemplary embodiment of the invention has 
naming context from the ORB, looks up the object reference been disclosed, it will be apparent to those skilled in the art 
for the query object implementation in the CORBA server that various changes and modifications can be made which 
and mitiahzes the query object as indicated in step 1308. ^ill achieve some of the advantages of the invention without 

Other methods in the TestQOFrame object then obtain departing from the spirit and scope of the invention. For 

information about the query object from the test object as example, it will be obvious to those reasonably skilled in the 

indicated in step 1310. The values returned by these methods art that, although the description was directed to a particular 

are used to create the test window 1200 generated by the hardware system and operating system, other hardware and 

TestQOFrame class constructor In step 1312, a pushbutton operating system software could be used in the same manner 

1202 is created and displayed for each query with the name as that described. Other aspects, such as the specific instruc- 

of the query displayed on the pushbutton. The routine then tions utilized to achieve a particular function, as well as 

proceeds, via off-page connectors 1314 and 1316, to step other modifications to the inventive concept are intended to 

1318 where a "stop" button 1204 is created and displayed. be covered by the appended claims. 

Next, in step 1320, a method in the TestQOFrame object What is claimed is: 
waits for a button press. If no button press is detected, the jq 1. An integrated development environment operable in a 

routine returns to step 1320 and continues waiting. computer with a memory for generating source code which 

Alternatively, if a button press is detected in step 1320, the implements and tests a query object that accesses a database, 

routine proceeds to step 1322, in which a determination is the query object having a method that, when invoked, 

made whether the stop button 1004 has been pressed. If so, submits a predefined query to the database, the environment 

the routine finishes in step 1326. comprising: 

Alternatively, if, in step 1322, the stop button has not been an internal state store which stores database-independent 

pressed, then the routine proceeds to step 1324 in which an information representing the query object in the 

object is instantiated from the RunQuery class 706. When memory, the database-independent information includ- 

the RunQuery class is instantiated, the query name, located ing a database-independent query to be implemented by 

on the button is passed in as a parameter. the query object; 

A method in the RunQuery object retrieves the query a first code generator which is responsive to the database- 
input parameter names and the output column titles from the independent information for generating source code 
query test object and uses these names to display a window which implements the query object and the method 
with input parameter names and output column titles such as from the database-independent query; 
that illustrated in FIG. 14. a second code generator which is responsive to the 

l^e display screen 1400 has an input parameter entry area database-independent information for generating test 

with the parameter input name 1402 identifying the param- code for the query object; 
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a builder which is responsive to the source code which 
implements the query object for building a query object 
program and is responsive to the source code which 
implements the test code for building a test program; 
and 5 

a test framework which operates with the test program to 
test the query object. 

2. An integrated environment according to claim 1 
wherein the database independent information is textual 
information. 

3. An integrated environment according to claim 1 further 
comprising a graphic user interface which generates a dis- 
play screen for the query object, the display screen display- 
ing database-independent information for each query in the 
query object. j5 

4. An integrated environment according to claim 3 
wherein the graphic user interface comprises an input 
mechanism which receives the database-independent query 
from a user and stores the database-independent query in the 
internal state store. 20 

5. An integrated environment according to claim 3 
wherein the graphic user interface controls the first and 
second code generators and the builder. 

6. An integrated environment according to claim 3 further 
comprising a database schema access object which includes 25 
a method for retrieving database metadata. 

7. An integrated environment according to claim 6 
wherein the database schema access object includes a 
method for retrieving database stored procedures. 

8. An integrated environment according to claim 6 3Q 
wherein the database schema access object displays the 
metadata on the display screen to enable the user to formu- 
late the database-independent query. 

9. An integrated environment according to claim 1 
wherein the test framework a generates a graphic user 35 
interface which controls testing of the query object. 

10. An integrated environment according to claim 1 
wherein the query object is a a distributed object and the first 
code generator is responsive to the database-independent 
information for generating source code which implements 
interface definitions for the query object. 

11. An integrated environment according to claim 1 
wherein the test code is class code for a distributed test 
object and the second code generator is responsive to the 
database-independent information for generating test code 45 
which implements interface definitions for the test object. 

12. An integrated environment according to claim 11 
wherein the query object is a distributed object and the test 
program installs the query object program as a server, 
connects to the query object and test the query object. 

13. A method for providing an integrated development 
environment operable in a computer with a memory for 
generating source code which implements and tests a query 
object that accesses a database, the query object having a 
method that, when invoked, submits a predefined query to 
the database, the method comprising the steps of: 

(a) storing database-independent information represent- 
ing the query object in the memory, the database- 
independent information including a database- 
independent query to be implemented by the query 59 
object; 

(b) generating source code which implements the query 
object and the method from the database-independent 
query in response to the database-independent infor- 
mation; 55 

(c) generating test -code for the query object in response to 
the database-independent information; 
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(d) building a query object program from the source code 
which implements the query object and building a test 
program from the source code which implements the 
test code; and 

(e) operating the test program with a test framework to 
test the query object. 

14. A method according to claim 13 wherein the database 
independent information is textual information. 

15. A method according to claim 13 further comprising 
the step of: 

(f) generating a display screen for the query object, the 
display screen displaying database-independent infor- 
mation for each query in the query object. 

16. A method according to claim 15 wherein step (f) 
comprises the step of: 

(fl) using a graphic input mechanism to receive the 
database-independent query from a user and to storethe 
database-independent query in the memory. 

17. A method according to claim 16 wherein the screen 
display controls steps (b),(c) and (d). 

18. A method according to claim 16 fiirther comprising 
the step of: 

(g) retrieving database metadata with a database schema 
access object. 

19. A method according to claim 18 wherein step (g) 
comprises the step of: 

(gl) retrieving database stored procedures with the data- 
base schema access object. 

20. A method according to claim 18 further comprising 
the step of: 

(h) using the database schema access object to display the 
metadata on the display screen to enable the user to 
formulate the database-independent query. 

21. A method according to claim 13 wherein step (e) 
comprises the step of: 

(el) using the test framework to generate a graphic user 
interface which controls testing of the query object. 

22. A method according to claim 13 wherein the query 
object is a distributed object and wherein step (b) comprises 
the step of: 

(bl) generating source code which implements interface 
definitions for the query object. 

23. A method according to claim 13 wherein the test code 
is class code for a distributed test object and wherein step (c) 
comprises the step of: 

(cl) generating test code which implements interface 
definitions for the test object. 

24. A method according to claim 23 wherein the query 
object is a distributed object and step (e) comprises the steps 
of: 

(e2) installing the query object program as a server; 
(e3) connecting to the query object; and 
(e4) testing the query object. 

25. A computer program product for providing an inte- 
grated development environment operable in a computer 
with a memory for generating source code which imple- 
ments and tests a query object that accesses a database, the 
query object having a method that, when invoked, submits 
a predefined query to the database, the computer program 
product comprising a computer usable medium having com- 
puter readable program code thereon, including: 

program code for storing database-independent informa- 
tion representing the query object in the memory, the 
database-independent information including a 
database-independent query to be implemented by the 
query object; 

program code for generating source code which imple- 
ments the query object and the method from the 
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database-independent query in response to the 

database-independent information; 
program code for generating test code for the query object 

in response to the database-independent information; 
program code for building a query object program from 5 

the source code which implements the query object and 
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building a test program from the source code which 
implements the test code; and 
test framework program code which operates with the test 
program to lest the query object. 

4t « « * * 
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